Micron Document
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
| SparkN0de-git | SparkN0de |
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------


Displaying Raw • Download


electron/safeConsole.js e41daa5b65e07a5baa1aaad32d97f90482f1cd1c (e41daa5b) Text, 5.30 KB

T8b949e// SPDX-License-Identifier: 0BSD

T8b949e/**
* Main-process log policy for Electron.
*
* Desktop launchers (AppImage, .desktop) often start MeshChatX with stdout
* attached to a pipe that later closes. Writing console.log then raises EPIPE.
* Prefer a durable file under the storage logs dir, and only mirror to stdout
* when it is still a TTY (or when forced via env).
*/

Tff7b72const Te6edf3fs Tff7b72= Te6edf3requireTb4b4b4(Ta5d6ff"node:fs"Tb4b4b4)Tb4b4b4;
Tff7b72const Te6edf3path Tff7b72= Te6edf3requireTb4b4b4(Ta5d6ff"node:path"Tb4b4b4)Tb4b4b4;

Tff7b72const Te6edf3ELECTRON_LOG_PREFIX Tff7b72= Ta5d6ff"[electron] "Tb4b4b4;

Tff7b72function Te6edf3isBrokenPipeErrorTb4b4b4(Te6edf3errTb4b4b4) Tb4b4b4{
Tff7b72if Tb4b4b4(Tff7b72!Te6edf3err Tff7b72|| Tff7b72typeof Te6edf3err Tff7b72!== Ta5d6ff"object"Tb4b4b4) Tb4b4b4{
Tff7b72return Tff7b72falseTb4b4b4;
Tb4b4b4}
Tff7b72if Tb4b4b4(Te6edf3errTb4b4b4.Te6edf3code Tff7b72=== Ta5d6ff"EPIPE" Tff7b72|| Te6edf3errTb4b4b4.Te6edf3errno Tff7b72=== Ta5d6ff"EPIPE"Tb4b4b4) Tb4b4b4{
Tff7b72return Tff7b72trueTb4b4b4;
Tb4b4b4}
Tff7b72const Te6edf3message Tff7b72= Tff7b72typeof Te6edf3errTb4b4b4.Te6edf3message Tff7b72=== Ta5d6ff"string" Tff7b72? Te6edf3errTb4b4b4.Te6edf3message Tff7b72: Ta5d6ff""Tb4b4b4;
Tff7b72return Ta5d6ff/\bEPIPE\b/iTb4b4b4.Te6edf3testTb4b4b4(Te6edf3messageTb4b4b4)Tb4b4b4;
Tb4b4b4}

T8b949e/**
* Attach no-op error listeners so closed stdout/stderr do not become
* uncaughtException dialogs when a write races the pipe close.
* @param {{ stdout?: NodeJS.WritableStream, stderr?: NodeJS.WritableStream } | null | undefined} [proc]
*/
Tff7b72function Te6edf3installBrokenPipeGuardsTb4b4b4(Te6edf3proc Tff7b72= Te6edf3processTb4b4b4) Tb4b4b4{
Tff7b72const Te6edf3attach Tff7b72= Tb4b4b4(Te6edf3streamTb4b4b4) Tb4b4b4=> Tb4b4b4{
Tff7b72if Tb4b4b4(Tff7b72!Te6edf3stream Tff7b72|| Tff7b72typeof Te6edf3streamTb4b4b4.Te6edf3on Tff7b72!== Ta5d6ff"function"Tb4b4b4) Tb4b4b4{
Tff7b72returnTb4b4b4;
Tb4b4b4}
Tff7b72if Tb4b4b4(Te6edf3streamTb4b4b4.Te6edf3__meshchatxBrokenPipeGuardedTb4b4b4) Tb4b4b4{
Tff7b72returnTb4b4b4;
Tb4b4b4}
Te6edf3streamTb4b4b4.Te6edf3__meshchatxBrokenPipeGuarded Tff7b72= Tff7b72trueTb4b4b4;
Te6edf3streamTb4b4b4.Te6edf3onTb4b4b4(Ta5d6ff"error"Tb4b4b4, Tb4b4b4(Te6edf3errTb4b4b4) Tb4b4b4=> Tb4b4b4{
Tff7b72if Tb4b4b4(Te6edf3isBrokenPipeErrorTb4b4b4(Te6edf3errTb4b4b4)Tb4b4b4) Tb4b4b4{
Tff7b72returnTb4b4b4;
Tb4b4b4}
Tb4b4b4}Tb4b4b4)Tb4b4b4;
Tb4b4b4}Tb4b4b4;
Te6edf3attachTb4b4b4(Te6edf3procTff7b72?Tb4b4b4.Te6edf3stdoutTb4b4b4)Tb4b4b4;
Te6edf3attachTb4b4b4(Te6edf3procTff7b72?Tb4b4b4.Te6edf3stderrTb4b4b4)Tb4b4b4;
Tb4b4b4}

T8b949e/**
* True when stdout is a live terminal, or MESHCHAT_FORCE_STDOUT_LOG=1.
* Packaged AppImage / desktop launches usually have isTTY false.
* @param {{ stdout?: { isTTY?: boolean } } | null | undefined} [proc]
* @param {NodeJS.ProcessEnv} [env]
*/
Tff7b72function Te6edf3shouldMirrorStdoutTb4b4b4(Te6edf3proc Tff7b72= Te6edf3processTb4b4b4, Te6edf3env Tff7b72= Te6edf3processTb4b4b4.Te6edf3envTb4b4b4) Tb4b4b4{
Tff7b72if Tb4b4b4(Te6edf3envTff7b72?Tb4b4b4.Te6edf3MESHCHAT_DISABLE_STDOUT_LOG Tff7b72=== Ta5d6ff"1"Tb4b4b4) Tb4b4b4{
Tff7b72return Tff7b72falseTb4b4b4;
Tb4b4b4}
Tff7b72if Tb4b4b4(Te6edf3envTff7b72?Tb4b4b4.Te6edf3MESHCHAT_FORCE_STDOUT_LOG Tff7b72=== Ta5d6ff"1"Tb4b4b4) Tb4b4b4{
Tff7b72return Tff7b72trueTb4b4b4;
Tb4b4b4}
Tff7b72return Tffa657BooleanTb4b4b4(Te6edf3procTff7b72?Tb4b4b4.Te6edf3stdout Tff7b72&& Te6edf3procTb4b4b4.Te6edf3stdoutTb4b4b4.Te6edf3isTTYTb4b4b4)Tb4b4b4;
Tb4b4b4}

T8b949e/**
* console.log that never throws on a closed stdout pipe.
* @param {...unknown} args
*/
Tff7b72function Te6edf3safeConsoleLogTb4b4b4(Tb4b4b4...Te6edf3argsTb4b4b4) Tb4b4b4{
Tff7b72try Tb4b4b4{
Te6edf3consoleTb4b4b4.Te6edf3logTb4b4b4(Tb4b4b4...Te6edf3argsTb4b4b4)Tb4b4b4;
Tb4b4b4} Tff7b72catch Tb4b4b4(Te6edf3errTb4b4b4) Tb4b4b4{
Tff7b72if Tb4b4b4(Tff7b72!Te6edf3isBrokenPipeErrorTb4b4b4(Te6edf3errTb4b4b4)Tb4b4b4) Tb4b4b4{
Tff7b72throw Te6edf3errTb4b4b4;
Tb4b4b4}
Tb4b4b4}
Tb4b4b4}

T8b949e/**
* @param {string} message
* @returns {string}
*/
Tff7b72function Te6edf3formatElectronLogLineTb4b4b4(Te6edf3messageTb4b4b4) Tb4b4b4{
Tff7b72const Te6edf3text Tff7b72= Tffa657StringTb4b4b4(Te6edf3message Tff7b72?? Ta5d6ff""Tb4b4b4)Tb4b4b4.Te6edf3replaceTb4b4b4(Ta5d6ff/\s+$/uTb4b4b4, Ta5d6ff""Tb4b4b4)Tb4b4b4;
Tff7b72return Ta5d6ff`Tffd700${Tff7b72new Tffa657DateTb4b4b4(Tb4b4b4)Tb4b4b4.Te6edf3toISOStringTb4b4b4(Tb4b4b4)Tffd700}Ta5d6ff Tffd700${Te6edf3ELECTRON_LOG_PREFIXTffd700}Tffd700${Te6edf3textTffd700}Ta5d6ff\nTa5d6ff`Tb4b4b4;
Tb4b4b4}

T8b949e/**
* Create a durable main-process logger that appends to meshchatx.log.
* @param {{
* getLogsDir: () => string | null | undefined,
* appendFileSync?: typeof fs.appendFileSync,
* mkdirSync?: typeof fs.mkdirSync,
* now?: () => Date,
* }} options
*/
Tff7b72function Te6edf3createMainProcessLoggerTb4b4b4(Te6edf3optionsTb4b4b4) Tb4b4b4{
Tff7b72const Te6edf3getLogsDir Tff7b72= Te6edf3optionsTb4b4b4.Te6edf3getLogsDirTb4b4b4;
Tff7b72const Te6edf3appendFileSync Tff7b72= Te6edf3optionsTb4b4b4.Te6edf3appendFileSync Tff7b72|| Te6edf3fsTb4b4b4.Te6edf3appendFileSyncTb4b4b4.Te6edf3bindTb4b4b4(Te6edf3fsTb4b4b4)Tb4b4b4;
Tff7b72const Te6edf3mkdirSync Tff7b72= Te6edf3optionsTb4b4b4.Te6edf3mkdirSync Tff7b72|| Te6edf3fsTb4b4b4.Te6edf3mkdirSyncTb4b4b4.Te6edf3bindTb4b4b4(Te6edf3fsTb4b4b4)Tb4b4b4;
Tff7b72const Te6edf3pending Tff7b72= Tb4b4b4[Tb4b4b4]Tb4b4b4;
Tff7b72let Te6edf3disabled Tff7b72= Tff7b72falseTb4b4b4;

Tff7b72function Te6edf3resolveLogPathTb4b4b4(Tb4b4b4) Tb4b4b4{
Tff7b72let Te6edf3logsDirTb4b4b4;
Tff7b72try Tb4b4b4{
Te6edf3logsDir Tff7b72= Te6edf3getLogsDirTff7b72?Tb4b4b4.Tb4b4b4(Tb4b4b4)Tb4b4b4;
Tb4b4b4} Tff7b72catch Tb4b4b4{
Tff7b72return Tff7b72nullTb4b4b4;
Tb4b4b4}
Tff7b72if Tb4b4b4(Tff7b72!Te6edf3logsDir Tff7b72|| Tff7b72typeof Te6edf3logsDir Tff7b72!== Ta5d6ff"string"Tb4b4b4) Tb4b4b4{
Tff7b72return Tff7b72nullTb4b4b4;
Tb4b4b4}
Tff7b72return Te6edf3pathTb4b4b4.Te6edf3joinTb4b4b4(Te6edf3logsDirTb4b4b4, Ta5d6ff"meshchatx.log"Tb4b4b4)Tb4b4b4;
Tb4b4b4}

Tff7b72function Te6edf3flushPendingTb4b4b4(Tb4b4b4) Tb4b4b4{
Tff7b72if Tb4b4b4(Tff7b72!Te6edf3pendingTb4b4b4.Te6edf3lengthTb4b4b4) Tb4b4b4{
Tff7b72returnTb4b4b4;
Tb4b4b4}
Tff7b72const Te6edf3logPath Tff7b72= Te6edf3resolveLogPathTb4b4b4(Tb4b4b4)Tb4b4b4;
Tff7b72if Tb4b4b4(Tff7b72!Te6edf3logPathTb4b4b4) Tb4b4b4{
Tff7b72returnTb4b4b4;
Tb4b4b4}
Tff7b72const Te6edf3chunk Tff7b72= Te6edf3pendingTb4b4b4.Te6edf3spliceTb4b4b4(T79c0ff0Tb4b4b4, Te6edf3pendingTb4b4b4.Te6edf3lengthTb4b4b4)Tb4b4b4.Te6edf3joinTb4b4b4(Ta5d6ff""Tb4b4b4)Tb4b4b4;
Tff7b72try Tb4b4b4{
Te6edf3mkdirSyncTb4b4b4(Te6edf3pathTb4b4b4.Te6edf3dirnameTb4b4b4(Te6edf3logPathTb4b4b4)Tb4b4b4, Tb4b4b4{ Te6edf3recursiveTff7b72: Tff7b72true Tb4b4b4}Tb4b4b4)Tb4b4b4;
Te6edf3appendFileSyncTb4b4b4(Te6edf3logPathTb4b4b4, Te6edf3chunkTb4b4b4, Tb4b4b4{ Te6edf3encodingTff7b72: Ta5d6ff"utf8" Tb4b4b4}Tb4b4b4)Tb4b4b4;
Tb4b4b4} Tff7b72catch Tb4b4b4{
Te6edf3disabled Tff7b72= Tff7b72trueTb4b4b4;
Tb4b4b4}
Tb4b4b4}

Tff7b72function Te6edf3writeToFileTb4b4b4(Te6edf3messageTb4b4b4) Tb4b4b4{
Tff7b72if Tb4b4b4(Te6edf3disabledTb4b4b4) Tb4b4b4{
Tff7b72returnTb4b4b4;
Tb4b4b4}
Tff7b72const Te6edf3line Tff7b72= Te6edf3formatElectronLogLineTb4b4b4(Te6edf3messageTb4b4b4)Tb4b4b4;
Tff7b72const Te6edf3logPath Tff7b72= Te6edf3resolveLogPathTb4b4b4(Tb4b4b4)Tb4b4b4;
Tff7b72if Tb4b4b4(Tff7b72!Te6edf3logPathTb4b4b4) Tb4b4b4{
Te6edf3pendingTb4b4b4.Te6edf3pushTb4b4b4(Te6edf3lineTb4b4b4)Tb4b4b4;
Tff7b72returnTb4b4b4;
Tb4b4b4}
Te6edf3flushPendingTb4b4b4(Tb4b4b4)Tb4b4b4;
Tff7b72try Tb4b4b4{
Te6edf3mkdirSyncTb4b4b4(Te6edf3pathTb4b4b4.Te6edf3dirnameTb4b4b4(Te6edf3logPathTb4b4b4)Tb4b4b4, Tb4b4b4{ Te6edf3recursiveTff7b72: Tff7b72true Tb4b4b4}Tb4b4b4)Tb4b4b4;
Te6edf3appendFileSyncTb4b4b4(Te6edf3logPathTb4b4b4, Te6edf3lineTb4b4b4, Tb4b4b4{ Te6edf3encodingTff7b72: Ta5d6ff"utf8" Tb4b4b4}Tb4b4b4)Tb4b4b4;
Tb4b4b4} Tff7b72catch Tb4b4b4{
Te6edf3disabled Tff7b72= Tff7b72trueTb4b4b4;
Tb4b4b4}
Tb4b4b4}

T8b949e/**
* Durable file write plus best-effort stdout when a TTY is present.
* @param {unknown} message
* @param {{ mirrorStdout?: boolean, proc?: NodeJS.Process, env?: NodeJS.ProcessEnv }} [opts]
*/
Tff7b72function Te6edf3writeTb4b4b4(Te6edf3messageTb4b4b4, Te6edf3opts Tff7b72= Tb4b4b4{Tb4b4b4}Tb4b4b4) Tb4b4b4{
Te6edf3writeToFileTb4b4b4(Te6edf3messageTb4b4b4)Tb4b4b4;
Tff7b72const Te6edf3mirror Tff7b72=
Te6edf3optsTb4b4b4.Te6edf3mirrorStdout Tff7b72!== Tff7b72undefined
Tff7b72? Te6edf3optsTb4b4b4.Te6edf3mirrorStdout
Tff7b72: Te6edf3shouldMirrorStdoutTb4b4b4(Te6edf3optsTb4b4b4.Te6edf3proc Tff7b72|| Te6edf3processTb4b4b4, Te6edf3optsTb4b4b4.Te6edf3env Tff7b72|| Te6edf3processTb4b4b4.Te6edf3envTb4b4b4)Tb4b4b4;
Tff7b72if Tb4b4b4(Te6edf3mirrorTb4b4b4) Tb4b4b4{
Te6edf3safeConsoleLogTb4b4b4(Te6edf3messageTb4b4b4)Tb4b4b4;
Tb4b4b4}
Tb4b4b4}

Tff7b72return Tb4b4b4{
Te6edf3writeTb4b4b4,
Te6edf3flushPendingTb4b4b4,
Te6edf3_pendingForTestsTff7b72: Te6edf3pendingTb4b4b4,
Te6edf3_formatLineForTestsTff7b72: Te6edf3formatElectronLogLineTb4b4b4,
Tb4b4b4}Tb4b4b4;
Tb4b4b4}

Te6edf3moduleTb4b4b4.Te6edf3exports Tff7b72= Tb4b4b4{
Te6edf3isBrokenPipeErrorTb4b4b4,
Te6edf3installBrokenPipeGuardsTb4b4b4,
Te6edf3safeConsoleLogTb4b4b4,
Te6edf3shouldMirrorStdoutTb4b4b4,
Te6edf3formatElectronLogLineTb4b4b4,
Te6edf3createMainProcessLoggerTb4b4b4,
Te6edf3ELECTRON_LOG_PREFIXTb4b4b4,
Tb4b4b4}Tb4b4b4;


──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────